SGWriteSamples(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Controlling Sequence Grabber Channel Components

SGWriteSamples
The sequence grabber component calls the SGWriteSamples function when it is ready to add recorded data to a movie.
pascal ComponentResult SGWriteSamples (SGChannel c, Movie m,
                                       AliasHandle theFile);
c
Identifies the channel connection for this operation.
m
Identifies the movie to which your component should add the captured data. Your component should not make any other changes to the movie identified by this reference. Use the SGWriteMovieData function, described on page 6-84.
theFile
Identifies the movie file. The sequence grabber component provides this alias so that you can supply it to the Movie Toolbox. You should not open this file or write to it directly. Use the SGWriteMovieData function.

DESCRIPTION
The sequence grabber component calls this function when the recording operation is complete, after calling your SGStop function (described on page 6-41). In this manner, your channel component can avoid unnecessary Movie Toolbox overhead during the record operation.

SPECIAL CONSIDERATIONS
Your component should dispose of any buffered data and add the captured data to the movie. If necessary, use the Movie Toolbox's functions to create a track and a media. See the chapter "Movie Toolbox" in Inside Macintosh: QuickTime for details.

RESULT CODES
File Manager errors
Memory Manager errors